home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 426-450 / disk_447 / dfc / dfc5.doc < prev    next >
Text File  |  1992-05-06  |  8KB  |  180 lines

  1.  
  2.  
  3.  
  4.                    DFC5 --- A disk formatter/copier
  5.  
  6.  
  7.               Written by Tom Rokicki & Sebastiano Vigna
  8.  
  9.  
  10. DFC5 is a new, exciting, general-purpose disk copier and formatter
  11. which we hope will meet the needs of a large number of Amiga users.
  12. This program is essentially a development of Tom Rokicki's previous
  13. DFC4 program:  the principle adopted has been to eliminate everything
  14. that wasn't absolutely necessary, to reduce the size of the program as
  15. much as possible, to squeeze every ounce of speed from the standard
  16. trackdisk.device through an utterly async design, and to incorporate a
  17. number of useful thrills such as voice, multiple passes copies and
  18. checksum for the RAM buffer.
  19.  
  20.  
  21. Main features:
  22.  
  23.  - DFC5 copies from/to any combination of Amiga drives.
  24.  
  25.  - DFC5 has a switchable 880K RAM buffer that allows for any number of
  26. duplicates while only reading the source disk once.  The combination
  27. of destination drives can be changed at each pass.
  28.  
  29.  - DFC5 checksums the RAM buffer.  If some badly written program is
  30. trashing your memory, you are alerted.  Thus, buffered copies are as
  31. safe as direct copies.
  32.  
  33.  - DFC5 is smaller than 11.5K, and even on a 1 megabyte Amiga you should
  34. be able to do single-pass multiple copies.
  35.  
  36.  - DFC5 will automatically switch to multiple (2, 3, or 4) pass copies
  37. if there isn't enough memory for a full 880K buffer.  This even allows
  38. for making multiple copies with multiple passes on any Amiga.
  39.  
  40.  - DFC5 starts from track 79---no more last-moment verify errors!
  41.  
  42.  - DFC5 lets you retry/skip any read, write or verify errors.
  43.  
  44.  - DFC5 is highly system-friendly.  Only drives actually used are
  45. inhibited, and the use of CPU time is negligible.
  46.  
  47.  - DFC5 is totally asynchronous, both in handling the disk and in the
  48. user interface; you can, for instance, turn verify on/off at any time,
  49. even while copying.
  50.  
  51.  - DFC5 has the option of incrementing the creation date of the copy
  52. so AmigaDOS doesn't get confused.  If, however, the option is switched
  53. on and the disk in not an AmigaDOS disk, the user is alerted.
  54.  
  55.  - DFC5 can be activated many times, and each copy can do a different
  56. task; for instance you can copy from DF0:  to DF1:, while formatting
  57. DF2:  and doing a multiple pass copy on DF3:!
  58.  
  59.  - DFC5 is faster than diskcopy---actually it pushes the use of the
  60. standard trackdisk.device to its limits (125 secs for a disk-to-disk
  61. copy).
  62.  
  63.  - DFC5 alerts the user with sound (and optionally voice) about the
  64. operations in progress---so you can really be doing something else!
  65.  
  66.  - DFC5 can format both OFS and FFS disks.
  67.  
  68.  
  69. To use DFC5, you have simply to click on its icon.  You will see four
  70. rows of gadgets.  The first one has at most one gadget selected:  it's
  71. the source.  The second one lets you select the destination drive(s).
  72. The third one contains the option gadgets.  The fourth one contains
  73. the action gadgets.  Notice that the Auto gadget is currently
  74. disabled; because of a bug in the 1.3 trackdisk.device, its
  75. implementation has been delayed to a 2.0-only version of the program.
  76.  
  77. Every gadget can be activated via mouse or via keyboard. The first row
  78. can be activated with 0,1,2,3, and the second one with 4,5,6,7. For the
  79. other gadgets, you can use the capital letter of its name.  The only
  80. exception is FFS, which will be activated by N (New File System).  F
  81. is already used for FORMAT.  As a bonus, you can use Q or ESC to exit,
  82. instead of hitting the close gadget.  Finally, you can use RETURN to
  83. start a copy operation---which means GO for a non-buffered copy, and
  84. REPEAT for a buffered copy (see below).
  85.  
  86.  
  87.  - VERIFY turns on and off verify at any time (you can also format
  88. without verifying)---but this is not recommended.
  89.  
  90.  - BUFFER allocates a buffer to make multiple copies.  Once a buffer
  91. is allocated, you can select the same drive for source and
  92. destination, and you can select REPEAT to make another copy of the
  93. same disk without rereading the original.  If DFC5 can't allocate an
  94. 880K buffer, it will try to allocate one for 2, 3 or 4 passes copies,
  95. and will alert the user accordingly (if no buffer at all can be
  96. allocated, a warning is issued).  To do multiple pass copies, GO a
  97. first time, REPEAT the first disk chunk for all the disks you need, GO
  98. another time to read another disk chunk etc.
  99.  
  100.  - TALK activates DFC5's abilities to give its status by voice.
  101. Currently only English is supported.
  102.  
  103.  - FFS enables the formatting of an FFS disk; for copying it is
  104. ignored.
  105.  
  106.  - DATE toggles on or off the slight change of the date of an AmigaDOS
  107. disk.  This change is necessary so AmigaDOS can distinguish otherwise
  108. identical disks; if two truly identical disks are inserted in the
  109. drives, AmigaDOS gets confused and crashes.  However, if for some
  110. reason you want a ``physical'' copy, you would turn off this option.
  111. A non-AmigaDOS disk copied with the DATE option on will generate a
  112. warning, since this option will probably subtly corrupt the disk.  You
  113. have time to switch off the DATE option, if you want, until the
  114. progress bar is in the middle.
  115.  
  116.  - STOP will stop at any time any operation.  Note that pressing STOP
  117. while a multiple pass copy buffer is allocated and no copy operation
  118. is running will reset the pass counter (i.e., you can start a fresh
  119. new copy).
  120.  
  121.  - GO copies from the source to the destination if BUFFER is switched
  122. off, or copies from the source to the buffer if BUFFER is switched on.
  123.  
  124.  - REPEAT works only with the buffer, and writes it to all
  125. destinations.  Note that when the buffer is on, you can select the
  126. same drive both in the source row and in the destination row.  This
  127. allows, for instance, to read a source from df0:  and then write it to
  128. both df0: and df1:.
  129.  
  130.  - FORMAT formats all destination drives.  If VERIFY is selected, the
  131. process is verified.
  132.  
  133. DFC5 will issue requesters if it finds an error on read, write, or
  134. verify.  You can ask to retry the operation or you can choose that you
  135. don't want to bother yourself with it.  If you want to stop, it's
  136. usually better to first press the STOP gadget and then cancel the
  137. requester, or another requester might be issued between the two
  138. operations.  Note that errors from the Unit 4 are checksum errors of
  139. the RAM buffer.
  140.  
  141. Because of a bug in the 1.3 trackdisk.device, a track with an error on
  142. a sector in it might be read completely wrong, yielding incorrect data
  143. even on the good sectors.
  144.  
  145. Please note that you have absolute freedom in the use of the RAM
  146. buffer:  this means some more care, too.  For instance, if while doing
  147. multiple pass copies you STOP two times, the pass counter will be
  148. reset.  But if you hit REPEAT at this time (before reading a new chunk
  149. with GO), DFC5 will write on what it thinks is the ``last pass read'',
  150. i.e., the last chunk of disk, even if this wasn't actually the last
  151. piece of disk read.  If you STOP while you're reading into the buffer,
  152. DFC5 will not increase the pass counter, since it thinks you have put
  153. in the wrong disk or something like that.  This means also that
  154. REPEATing at this time will write on the previous disk chunk, with the
  155. first tracks probably trashed by the stopped GO operation.  So be
  156. careful.  A more restrictive mechanism will be implemented in the
  157. 2.0-only release.
  158.  
  159. The progress bar is drawn in a different color if you're doing a GO
  160. for a buffered operation---so you can be sure you read the new chunk
  161. in the buffer.  Note also that the progress bar is not updated if
  162. something locked the screen (like using menus).  The update is delayed
  163. until the screen is unlocked (thus DFC5 won't get stuck as will almost
  164. all programs which do any rendering to their windows).
  165.  
  166. This program is in the public domain; anyone can do anything they want
  167. with it.  This software is made available on an as-is basis; don't
  168. come to us if you destroy your entire fish disk library with it!  Of
  169. course, it was tested rather extensively before it was released . . .
  170.  
  171. Comments, complaints, desiderata are welcome.
  172.  
  173.  
  174.  
  175.  
  176.                 Tomas Rokicki                   Sebastiano Vigna
  177.                 Box 2081                        BIX: svigna
  178.                 Stanford, CA 94309.             Via Valparaiso, 18
  179.                 U.S.A.                          I-20144 Milano ITALY
  180.